๐Ÿ“บ 2. ์Šคํ”„๋ง ์›น ๊ฐœ๋ฐœ ๊ธฐ์ดˆ

@Seongukbaek Posted January 03, 2022 ยท Updated January 03, 2022 ยท 8 min read

์Šคํ”„๋ง ์ž…๋ฌธ - ์ฝ”๋“œ๋กœ ๋ฐฐ์šฐ๋Š” ์Šคํ”„๋ง ๋ถ€ํŠธ, ์›น MVC, DB ์ ‘๊ทผ ๊ธฐ์ˆ ์„ ๋“ค์œผ๋ฉฐ ์ •๋ฆฌํ•˜๋Š” POST์ž…๋‹ˆ๋‹ค.

์ „์ฒด์ ์ธ ํ๋ฆ„

  • Spring Project ์ƒ์„ฑ
  • Spring boot๋กœ ์›น ์„œ๋ฒ„ ์‹คํ–‰
  • ํšŒ์› ๋„๋ฉ”์ธ ๊ฐœ๋ฐœ
  • ์›น MVC ๊ฐœ๋ฐœ
  • DB ์—ฐ๋™ - JDBC, JPA, Spring data JPA
  • ํ…Œ์ŠคํŠธ ์ผ€์ด์Šค ์ž‘์„ฑ

๐Ÿ” ์ •์  ์ปจํ…์ธ 

โ› ์ •์  ์ปจํ…์ธ ๋ž€?

  • ์„œ๋ฒ„์— ์ €์žฅ๋˜์–ด ์žˆ๊ณ  ๋ณ€ํ™” ์—†์ด ๋ธŒ๋ผ์šฐ์ €๋กœ ๋ฟŒ๋ ค์ง€๋Š” ์ปจํ…์ธ (ํŒŒ์ผ)
  • ์š”์ฒญ์— ๋”ฐ๋ผ ์‘๋‹ต๋งŒ์„ ์ˆ˜ํ–‰

Spring Boot๋Š” ์ •์  ์ปจํ…์ธ  ๊ธฐ๋Šฅ ์ž๋™ ์ œ๊ณต
โ†’ https://docs.spring.io/spring-boot/docs/2.3.1.RELEASE/reference/html/spring-boot-features.html#boot-features-spring-mvc-static-content

  • /static ํด๋”์—์„œ ์ •์  ์ปจํ…์ธ ๋ฅผ ์ฐพ์•„์„œ ์ œ๊ณตํ•œ๋‹ค.

/static ์— hello-static.html ์„ ์ƒ์„ฑ ๋ฐ ์ž‘์„ฑํ•ด๋ณด์ž.

  • ํŒŒ์ผ ์ž‘์„ฑ ํ›„ ์„œ๋ฒ„๋ฅผ ๋™์ž‘์‹œํ‚ค๋ฉด, http://localhost:8080/hello-static.html ์—์„œ ์ž‘์„ฑํ•œ ์ •์  ์ปจํ…์ธ ์ธ html ํŒŒ์ผ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

๐Ÿ” MVC์™€ ํ…œํ”Œ๋ฆฟ ์—”์ง„

โ› ํ…œํ”Œ๋ฆฟ ์—”์ง„์ด๋ž€?

  • ์„œ๋ฒ„์—์„œ ๋™์ ์œผ๋กœ ํŒŒ์ผ์„ ๋ฐ”๊ฟ”์„œ ๋ธŒ๋ผ์šฐ์ €๋กœ ๋ฟŒ๋ ค์ฃผ๋Š” ์—”์ง„
  • jsp, php ๋“ฑ์ด ์žˆ๋‹ค.
  • ์ด๋ฅผ ์œ„ํ•ด ํ•„์š”ํ•œ Model, View, Controller๋ฅผ ํ•ฉ์ณ MVC๋ผ๊ณ  ํ•œ๋‹ค.
  • ์˜ˆ์ „์—๋Š” View๋งŒ์œผ๋กœ ๊ฐœ๋ฐœ์„ ์ง„ํ–‰ํ–ˆ๋‹ค๋ฉด, ์ด์ œ๋Š” View๋Š” ํ™”๋ฉด์„ ๊ทธ๋ฆฌ๋Š” ๋ฐ์—๋งŒ ์ง‘์ค‘ํ•˜๊ณ , Model & Controller๋Š” Business logic๊ณผ ๊ด€๋ จ์žˆ๊ฑฐ๋‚˜, ๋‚ด๋ถ€์ ์ธ ๊ฒƒ๋“ค์„ ์ฒ˜๋ฆฌํ•˜๋Š”๋ฐ ์ง‘์ค‘ํ•˜๊ธฐ ์œ„ํ•ด ์ด๋ฅผ ๋ถ„๋ฆฌํ•˜์˜€๋‹ค.

    • !๋ฉด์ ‘ ์งˆ๋ฌธ!

      • ์œ ์ง€๋ณด์ˆ˜์„ฑ
      • ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ํ™•์žฅ์„ฑ
      • ์œ ์—ฐ์„ฑ ์ฆ๊ฐ€(ํด๋ผ์ด์–ธํŠธ์˜ ์ƒˆ๋กœ์šด ์š”๊ตฌ์‚ฌํ•ญ์— ๋Œ€ํ•ด ์ตœ์†Œํ•œ์˜ ๋น„์šฉ์œผ๋กœ ๋ณด๋‹ค ์œ ์—ฐํ•˜๊ฒŒ ๋Œ€์ฒ˜)
      • ์ค‘๋ณต์ฝ”๋”ฉ์˜ ๋ฌธ์ œ์  ๊ฐ์†Œ
    • ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด ์œ ์ง€, ๋ณด์ˆ˜์— ์—„์ฒญ๋‚œ ์‹œ๊ฐ„์ด ํ•„์š”ํ•  ๊ฒƒ์ด๋‹ค ...

์ •์  ์ปจํ…์ธ ์™€ ๋‹ค๋ฅธ ์  ์„œ๋ฒ„์—์„œ ๋ฟŒ๋ ค์งˆ ์ปจํ…์ธ ์— ๋™์ ์œผ๋กœ ๋ณ€ํ™”๋ฅผ ์ค„ ์ˆ˜ ์žˆ๋‹ค.

์ด๋ฒˆ์—๋Š” MVC๋ฅผ ์ด์šฉํ•˜์—ฌ Parameter๋ฅผ ๋ฐ›๋Š” Controller๋ฅผ ์ƒ์„ฑํ•ด๋ณด์ž.

controller/HelloController.java

@GetMapping("hello-mvc") public String helloMvc(@RequestParam ("name") String name, Model model) { model.addAttribute("name", name); return "hello-template"; }
  • @RequestParam annotation์€ HTTP request parameter๋ฅผ method์˜ parameter๋กœ ์ „๋‹ฌ๋ฐ›์„ ๋•Œ ์‚ฌ์šฉํ•œ๋‹ค. form ์—์„œ์˜ input ์˜ name ๊ณผ ๋งค์นญ๋˜์–ด ํ•ด๋‹น ๊ฐ’์„ ๋ฐ›์•„์˜ฌ ์ˆ˜ ์žˆ๋‹ค.
  • String name ์— ํ•ด๋‹น ๊ฐ’์„ ๋‹ด๊ณ , Model model ์„ ์ด์šฉํ•˜์—ฌ View ์—์„œ rendering ์‹œ ์‚ฌ์šฉ
  • model.addAttribute method๋กœ key ๊ฐ€ "name" ์ด๊ณ , ๋ณ€์ˆ˜์ด๋ฆ„ ์ด name ์ธ ๊ฐ’์„ ๊ฐ€์ ธ์™€์„œ View ๋กœ ์ „๋‹ฌํ•œ๋‹ค.

resources/templates/hello-templates.html

<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <body> <p th:text="'hello' + ${name}">hello! empty</p> </body> </html>
  • xmlns:th="~" ๋กœ thymeleaf ํ…œํ”Œ๋ฆฟ์„ ์‚ฌ์šฉํ•จ์„ ๋ช…์‹œ

    • thymeleaf์˜ ์žฅ์ ์€, ์œ„์™€ ๊ฐ™์ด ์ €์žฅํ•œ ํŒŒ์ผ ์ž์ฒด๋ฅผ ์„œ๋ฒ„์—†์ด ์—ด์–ด๋„ ํ•ด๋‹น ํŒŒ์ผ์˜ ์†Œ์Šค์ฝ”๋“œ๋ฅผ ๊ทธ๋Œ€๋กœ ํ™•์ธ ๊ฐ€๋Šฅํ•˜๋‹ค.
    • ์„œ๋ฒ„๊ฐ€ ๋™์ž‘ํ•˜๊ฒŒ ๋˜๋ฉด, th:text ์— ์žˆ๋Š” ๊ฐ’์œผ๋กœ hello! empty ๊ฐ€ ์น˜ํ™˜๋œ๋‹ค.

์„œ๋ฒ„๋ฅผ ๋™์ž‘์‹œ์ผœ http://localhost:8080/hello-mvc ๋กœ ์ ‘์†

WARN 51004 --- [nio-8080-exec-1] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.bind.MissingServletRequestParameterException: Required request parameter 'name' for method parameter type String is not present]
  • ์œ„์™€ ๊ฐ™์€ log์™€ ํ•จ๊ป˜ Error page๊ฐ€ ๋‚˜์˜ค๋Š” ๊ฒƒ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค. ์‰ฝ๊ฒŒ ๋งํ•ด name parameter์— ์•„๋ฌด๊ฒƒ๋„ ๋„˜๊ฒจ์ฃผ์ง€ ์•Š์•„์„œ ๋œจ๋Š” ์—๋Ÿฌ๋ผ๊ณ  ํ•  ์ˆ˜ ์žˆ๋‹ค.
@GetMapping("hello-mvc") public String helloMvc(@RequestParam (name = "name") String name, Model model) { model.addAttribute("name", name); return "hello-template"; }
  • ์œ„์™€ ๊ฐ™์ด, parameter์˜ ์ด๋ฆ„์„ ๋ช…์‹œํ•˜๊ณ , required option์€ ๊ธฐ๋ณธ๊ฐ’์ด true ์ด๋ฏ€๋กœ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค.

์ด์ œ http://localhost:8080/hello-mvc?name=spring ์œผ๋กœ ์ ‘์†ํ•ด๋ณด์ž.

  • ๋™์ž‘๋ฐฉ์‹์€,

    1. url์—์„œ ๋ฐ›์•„์˜จ name์— ๋Œ€ํ•œ "spring" ์ด๋ผ๋Š” ๊ฐ’์ด public Stirng helloMvc ์˜ String name ์— ๋‹ด๊ธฐ๊ณ ,
    2. model.addAttribute ๋ฅผ ํ†ตํ•ด name ์ด model ์— ๋‹ด๊ฒจ, hello-template ์œผ๋กœ return
    3. ${name} ์œผ๋กœ, model ์—์„œ key๊ฐ’์ด name ์ธ ๊ฐ’์„ ๊ฐ€์ ธ์™€์„œ ์น˜ํ™˜!

๐Ÿ” API

  • JSON ์ด๋ผ๋Š” ๋ฐ์ดํ„ฐ ํฌ๋งท์œผ๋กœ ์„œ๋ฒ„์—์„œ ํด๋ผ์ด์–ธํŠธ๋กœ ๋ฐ์ดํ„ฐ๋ฅผ ์ „์†กํ•˜๋Š” ๋ฐฉ์‹
@GetMapping("hello-string") @ResponseBody public String helloString(@RequestParam("name") String name) { return "hello" + name; }
  • @ResponseBody ๋Š”, http์—์„œ์˜ body์— ํ•ด๋‹น ๋‚ด์šฉ์„ ์ง์ ‘ ๋„ฃ๊ฒ ๋‹ค๋Š” ์˜๋ฏธ!
  • Template engine๊ณผ ๋‹ค๋ฅธ ์ ์€ "view" ๊ฐœ๋… ์—†์ด data๊ฐ€ ๊ทธ๋Œ€๋กœ ๋ณด์—ฌ์ง„๋‹ค.

    • ํ™•์ธํ•˜๊ธฐ ์œ„ํ•ด, http://localhost:8080/hello-string?name=spring ์œผ๋กœ ์ ‘์†ํ•˜๋ฉด, ์•„๋ž˜์™€ ๊ฐ™์€ ํ™”๋ฉด์ด ๋ณด์ด๊ณ , ํŽ˜์ด์ง€ ์†Œ์Šค ๋ณด๊ธฐ ํ•˜๋ฉด, html code ์—†์ด Data๋งŒ ์กด์žฌํ•˜๋Š” ๊ฒƒ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

๋‹ค์Œ ์˜ˆ์ œ๋Š” Hello ๊ฐ์ฒด์™€ getName & setName, ๊ทธ๋ฆฌ๊ณ  ๊ฐ์ฒด๋ฅผ return ํ•˜๋Š” Api ๋ฐฉ์‹์ด๋‹ค.

@GetMapping("hello-api") @ResponseBody public Hello helloApi(@RequestParam("name") String name) { Hello hello = new Hello(); hello.setName(name); return hello; } static class Hello { private String name; public String getName() { return name; } public void setName(String name) { this.name = name; } }
  • http://localhost:8080/hello-api?name=spring ์œผ๋กœ ์ ‘์†ํ•˜๋ฉด ์•„๋ž˜ ์‚ฌ์ง„์—์„œ ๋ณด์ด๋Š” ๋ฐ”์™€ ๊ฐ™์ด Key & Value ๋กœ ์ด๋ฃจ์–ด์ง„ JSON ๊ตฌ์กฐ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

mac ๊ธฐ์ค€ โŒ˜ + n ์œผ๋กœ Getter์™€ Setter๋ฅผ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ๋‹ค. Hello Class ์•ˆ์— ์žˆ๋Š” String name ์€ private ์ด๋ฏ€๋กœ, ํ•ด๋‹น ๋ณ€์ˆ˜์— ๋Œ€ํ•œ ์ ‘๊ทผ์€ ์˜ค์ง public ํ•œ getName or setName ์œผ๋กœ๋งŒ ๊ฐ€๋Šฅํ•˜๊ฒŒ ํ•œ๋‹ค. โ†’ JavaBeans ํ‘œ์ค€ ๋ฐฉ์‹

  • ์ด์™€ ๊ฐ™์ด @ResponseBody ๋ฅผ ์‚ฌ์šฉํ•œ ๋™์ž‘๋ฐฉ์‹์€,
  • localhost:8080/hello-api๋กœ ์ด๋™ํ•˜์—ฌ controller๊ฐ€ ์ด๋ฅผ ํ™•์ธ
  • template engine์˜ ๊ฒฝ์šฐ, ํ•ด๋‹นํ•˜๋Š” view๋ฅผ ๋ณด์—ฌ์ฃผ๊ธฐ ์œ„ํ•ด viewResolver์—๊ฒŒ ์ „๋‹ฌํ–ˆ์ง€๋งŒ @ResponseBody ๋ฅผ ๋ฐœ๊ฒฌํ•˜๋ฉด http ์‘๋‹ต์— ํ•ด๋‹น Data๋ฅผ ๊ทธ๋Œ€๋กœ ์ „๋‹ฌํ•˜๊ธฐ ์œ„ํ•œ ์ฒ˜๋ฆฌ๋ฅผ ์ˆ˜ํ–‰
  • ์ด๋•Œ, ์ „๋‹ฌํ•˜๋ ค๋Š” Data๊ฐ€ ๋ฌธ์ž์—ด์ด ์•„๋‹Œ ๊ฐ์ฒด์ด๋ฏ€๋กœ ์ด์— ๋Œ€ํ•œ ์ฒ˜๋ฆฌ๊ฐ€ ํ•„์š”ํ•˜๋‹ค.

    • Spring์˜ ๊ธฐ๋ณธ ์ •์ฑ…์€ ๊ฐ์ฒด๊ฐ€ ์˜ค๋Š” ๊ฒฝ์šฐ, ์ด๋ฅผ JSON ๋ฐฉ์‹์œผ๋กœ Http ์‘๋‹ต์— ๋ฐ˜ํ™˜ํ•˜๋Š” ๊ฒƒ
  • ViewResolver ๋Œ€์‹  HttpMessageConverter ๊ฐ€ ๋™์ž‘ํ•˜์—ฌ String์ธ ๊ฒฝ์šฐ๋Š” StringConverter, ๊ฐ์ฒด์ธ ๊ฒฝ์šฐ๋Š” JsonConverter ๋ฅผ ๋™์ž‘์‹œํ‚ด

    • ๋Œ€ํ‘œ์ ์ธ JsonConverter library๋กœ๋Š” MappingJacksonHttpMessageConveter ์™€ GsonHttpMessageConveter ๊ฐ€ ์žˆ๋‹ค.
    • HttpMessageConverter๋Š” ํด๋ผ์ด์–ธํŠธ๊ฐ€ ์›ํ•˜๋Š” response ํ˜•ํƒœ๋ฅผ header์— ๋ช…์‹œํ•œ ๊ฒฝ์šฐ, ์ด์— ๋งž์ถฐ ์„ ํƒ๋œ๋‹ค. ๊ทธ๋ ‡์ง€ ์•Š์€ ๊ฒฝ์šฐ๋Š” spring์ด ์•Œ์•„์„œ ์„ ํƒ!
    • MessageConverter์— ๋Œ€ํ•œ ์ž์„ธํ•œ ์ •๋ณด๋Š” ์ฐธ๊ณ ์— ์žˆ๋Š” HttpMessageConverter ๋ฅผ ํ™•์ธ
  • Converter๋ฅผ ์ด์šฉํ•ด ๋ณ€ํ™˜๋œ ๊ฒฐ๊ณผ๋ฅผ ์š”์ฒญ์ธก์œผ๋กœ ์ „๋‹ฌ

์˜ˆ์ „์—๋Š” JSON์ด ์•„๋‹Œ XML ๋ฐฉ์‹์„ ์‚ฌ์šฉํ–ˆ์—ˆ๋Š”๋ฐ, (ex. html code) ์ด๋Š” ์—ด๊ณ  ๋‹ซ๋Š” ์ด์ค‘์˜ code๊ฐ€ ํ•„์š”ํ•˜๊ณ , ๋ฌด๊ฒ๋‹ค๋Š” ๋‹จ์ ๋•Œ๋ฌธ์— ์ตœ๊ทผ์—๋Š” Simpleํ•œ JSON ํ˜•ํƒœ๋ฅผ ๋งŽ์ด ์‚ฌ์šฉํ•œ๋‹ค.


๐Ÿ“Œ ์ค‘์š”ํ•œ ๊ฐœ๋…

Template engine, API, Annotation, HttpMessageConverter, JavaBeans

๐Ÿ“• ์ฐธ๊ณ 

@Seongukbaek
๋ฐฐ์šฐ๊ณ  ์ •๋ฆฌํ•˜๊ณ  ๊ณต์œ ํ•˜๋Š” ๋Œ€ํ•™์ƒ ๋ฐฑ์„ฑ์šฑ์ž…๋‹ˆ๋‹ค ๐Ÿ˜€